在 Raspberry Pi 5（Ubuntu 25.04）上部署 .NET 9 SDK

1. 文件目的

本文件旨在說明如何於 Raspberry Pi 5（採用 arm64 架構）與 Ubuntu Server 25.04 作業系統的環境中，部署 .NET 9 軟體開發套件（Software Development Kit, SDK）。 .NET 是由 Microsoft 所開發的免費、開源且跨平台的開發平台，廣泛用於建構現代化的各類應用程式。

本指南涵蓋下列內容：註冊 Microsoft 官方套件來源、安裝 .NET 9 SDK，以及驗證安裝結果。

2. 適用環境

本操作程序適用於以下系統環境：

硬體平台：Raspberry Pi 5（arm64 架構）
作業系統：Ubuntu Server 25.04
權限要求：具備 sudo 指令執行權限的使用者帳戶
網路需求：需可正常連接至網際網路

3. 部署程序

在 Ubuntu 上安裝 .NET 的建議做法，是透過設定 Microsoft 官方的 APT 軟體庫，以確保安裝來源的可靠性，並利於後續的套件更新與管理。

3.1. 註冊 Microsoft 套件來源

此步驟僅需於每部主機執行一次，即可將 Microsoft 的套件來源加入系統的 APT 設定中。

更新系統並安裝必要套件 確保系統已更新，並安裝 wget 以利後續檔案下載：
```
sudo apt update
sudo apt upgrade -y
sudo apt install wget -y
```

下載並安裝 Microsoft 的 GPG 金鑰與套件來源設定 Microsoft 提供 .deb 套件，以便自動設定套件來源與簽署金鑰：

wget https://packages.microsoft.com/config/ubuntu/25.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

清除安裝檔案 移除已完成設定的 .deb 檔案：
```
rm packages-microsoft-prod.deb
```

3.2. 安裝 .NET 9 SDK

完成來源設定後，即可透過 APT 套件管理工具安裝 .NET 9 SDK：

重新整理套件清單：
```
sudo apt update
```
安裝 .NET 9 SDK 安裝 SDK 將包含對應的 .NET Runtime 與 ASP.NET Core Runtime：
```
sudo apt install -y dotnet-sdk-9.0
```

4. 驗證安裝

為確認 SDK 已正確部署並可正常使用，建議執行以下幾項驗證：

4.1. 檢查 SDK 版本

使用以下指令檢查安裝的 SDK 版本：

dotnet --version

預期輸出應為 9.0.xxx 或更高版本。

4.2. 顯示完整 .NET 環境資訊

使用以下指令可查看詳細的 SDK 與 Runtime 資訊：

dotnet --info

輸出中應包含 .NET SDK 9.0 版本資訊、對應的 Runtime，以及安裝路徑等細節。

4.3. 建立並執行 “Hello, World” 專案

此步驟可確認 SDK 能正確執行專案的建置與執行：

建立專案資料夾並進入：

mkdir helloworld_dotnet
cd helloworld_dotnet

建立主控台應用程式專案：
```
dotnet new console
```
執行應用程式：
```
dotnet run
```

若順利執行，終端機應輸出：

Hello, World!

這代表 .NET 9 SDK 已成功安裝，並可在 Raspberry Pi 5 上正常運作。

5. 附註：僅安裝執行環境（Runtime）

若僅需在生產環境執行已建置好的 .NET 應用程式，可選擇僅安裝執行環境：

安裝 .NET Runtime（適用於主控台應用程式）：
```
sudo apt install dotnet-runtime-9.0
```
安裝 ASP.NET Core Runtime（適用於 Web 應用程式）：
```
sudo apt install aspnetcore-runtime-9.0
```

6. 結語

依照本文件步驟完成所有程序後，.NET 9 SDK 即已成功部署至目標系統並通過基本驗證。此時，您的 Raspberry Pi 5 平台已具備開發、建置與執行基於 .NET 9 的現代化、高效能、跨平台應用程式的完整能力。